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MCALL . MODULE 

MODULE OHANDL* RELEASE=V05> vERSION^OI, COMMENT-<Overiay Handier>> IDENT=NO* LIB=YES 

COPYRIGHT <c> 1984 BY 
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS. 
ALL RIGHTS RESERVED. 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED 
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER 
COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY 
OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY 
TRANSFERRED. 

THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE 
AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT 

CORPORATION. 



DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY 
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 
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i MAS, SHD 

. SBTTL THE RUN-TIME OVERLAY HANDLER 
. ENABL GBL 



THE FOLLOWING CODE IS INCLUDED IN THE USER'S PROGRAM BY THE 
LINKER WHENEVER LOW MEMORY OVERLAYS ARE REQUESTED BY THE USER. 
THE RUN-TIME LOW MEMORY OVERLAY HANDLER IS CALLED BY A DUMMY 
SUBROUTINE OF THE FOLLOWING FORM: 



JSR R5, *OVRH 

. WORD COVERLAY # *6> 

. WORD <ENTRY ADDRES5> 



CALL TO COMMON CODE FOR LOW MEMORY OVERLAYS 

# OF DESIRED SEGMENT 

ACTUAL CORE ADDRESS (VIRTUAL ADDRESS) 



ONE DUMMY ROUTINE OF THE ABOVE FORM IS STORED IN THE RESIDENT PORTION 

OF THE USER'S PROGRAM FOR EACH ENTRY FOINT TO A LOW MEMORY OVERLAY SEGMENT. 

ALL REFERENCES TO THE ENTRY POINT ARE MODIFIED BY THE LINKER TO BE 

REFERENCES TO THE APPROPRIATE DUMMY ROUTINE. EACH OVERLAY SEGMENT 

IS CALLED INTO CORE AS A UNIT AND MUST BE CONTIGUOUS IN CORE. AN 

OVERLAY SEGMENT MAY HAVE ANY NUMBER OF ENTRY POINTS, TO THE LIMITS 

OF CORE MEMORY. ONLY ONE SEGMENT AT A TIME MAY OCCUPY AN OVERLAY REGION. 

THERE IS ONE WORD PREFIXED TO EVERY OVERLAY REGION THAT IDENTIFIES THE 
SEGMENT CURRENTLY RESIDENT IN THAT OVERLAY REGION. THIS WORD IS AN INDEX 
INTO THE OVERLAY TABLE AND POINTS AT THE OVERLAY SEGMENT INFORMATION. 

UNDEFINED GLOBALS IN THE OVERLAY HANDLER MUST BE NAMED "*0VDF1" TO 
'^OVOFn" SUCH THAT A RANGE CHECK MAY BE DONE BY LINK TO DETERMINE IF 
THE UNDEFINED GLOBAL NAME IS FROM THE OVERLAY HANDLER. A CHECK IS 
DONE ON THE . RAD50 CHARACTERS "SOV'S AND THEN A RANGE CHECK IS DONE ON 
THE . RAD50 CHARATERS "DF1" TO "DFn". THESE GLOBAL SYMBOLS DO NOT APPEAR 
ON LINK MAPS, SINCE THEIR VALUE IS NOT KNOWN UNTIL AFTER THE MAP HAS BEEN 
PRINTED. CURRENTLY *0VDF1 TO S0VDF5 ARE IN USE. 

GLOBAL SYMBOLS 0*READ AND 0*D0NE ARE USEFUL WHEN DEBUGGING OVERLAID 
PROGRAMS. 



0*READ: : WILL APPEAR IN THE LINK MAP AND LOCATES THE 
STATEMENT IN THE OVERLAY HANDLER. 



READW 



0*DONE: : WILL APPEAR IN THE LINK MAP AND LOCATES THE FIRST 
INSTRUCTION AFTER THE . READW IN THE OVERLAY HANDLER. 
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MCALL . READW, . . VI. . 

. . Vi. . ; VI FORMAT 

SBTTL *OVTAB OVERLAY TABLE 

PSECT *OTABL, D, GBL, OVR 

+ 
OVERLAY TABLE STRUCTURE: 



LOC 64 -> 



*OVTAB: 

. WORD <CORE ADDR>.« CRELATIVE BLK>.. <WORD COUNT> 

DUMMY SUBROUTINES FOR ALL OVERLAY SEGMENTS 



/n OVERLAYS 



SOVTAB . 
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OOOOOO 
000000 



OOOOOO 
000002 
000004 
000006 

000010 

000010 

000012 
000016 
000020 
000022 
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28 
29 
30 
31 
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33 
34 
35 
36 
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39 
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52 

Errors detected 



000024 
000036 
000040 
000042 
000044 
000046 
000050 

000052 
000054 

000056 
000064 
000070 
000072 
000076 
000100 

000102 
000104 



060502 
01C046 
010146 
010246 



062701 
012102 
022512 
001406 



103405 
012602 
012601 
012600 
011505 
000205 

104376 
000 

012767 
016701 
005021 
020167 
103774 
000743 

OOOOOOG 
OOOOOOG 



000001 
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. 3BTTL OVERLAY HANDLER CuDE 

. PSECT *OHAND, GBL 

. PSECT ZOHAND. GBL, OVR 

. ENABL LSB 

; $OVRH IS THE ENTRY POINT TO THE OVERLAY HANDLER 



i 



$QVRH: : 



1*: 



. RAD50 /OVR/ 
MOV RO--(SP) 
MOV R 1 , - < SP ) 



MOV 



Ri 



•<SP) 



177772 



2$: 



BR 


5* 


MOV 


<?R5,R1 


ADD 


#*0VTAB~6, Rl 


MOV 


<R1)+,R2 


CMP 


<R5)+, @R2 


BEG. 


3* 



THIS KEEPS HANDLER THE SAME SIZE AS V03 
/O OVERLAY ENTRY POINT 
SAVE REGISTERS 



FIRST CALL ONLY * * * 

PICK UP OVERLAY NUMBER 

CALC TABLE ADDR 

GET FIRST ARG. OF OVERLAY SEG. ENTRY 

IS OVERLAY ALREADY RESIDENT? 

YES, BRANCH TO IT 






THE . READW ARGUMENTS ARE AS FOLLOWS: 

CHANNEL NUMBER, CORE ADDRESS, LENGTH TO READ, RELATIVE BLOCK ON DISK. 

THESE ARE USED IN REVERSE ORDER FROM THAT SPECIFIED IN THE CALL. 



(Rl)+ ;READ FROM OVERLAY FILE 
; RESTORE USERS REGISTERS 



373 

011501 
000012 

000006 



177724 



0*READ: 


: . READW 


17, R2, @R1, 


0*DONE: 


: BCS 


4* 


3*: 


MOV 


<SP>+, R2 




MOV 


(SP)+, Rl 




MOV 


(SP)+, RO 




MOV 


@R5, R5 




RTS 


R5 


4*: 


EMT 


376 




. BYTE 


0, 373 


5*: 


MOV 


#11501, 1* 




MOV 


*0DF1, Rl 


6*: 


CLR 


<R1> + 




CMP 


R1,*0DF2 




BLO 


6$ 




BR 


1* 


*0DF1: : 


. WORD 


*0VDF1 


*0DF2: : 


, WORD 


*0VDF2 


. DSABL 


LSB 




. END 







i GET ENTRY ADDRESS 

; ENTER OVERLAY ROUTINE AND RESTORE USER'S R5 

; SYSTEM ERROR 10 (OVERLAY I/O) 



; RESTORE SWITCH INSTR (MOV @R5, Rl ) 

; START ADDR FOR CLEAR OPERATION 

i CLEAR ALL OVERLAY REGIONS 

i DONE? 

i LO -> NO, REPEAT 

i AND RETURN TO CALL IN PROGRESS 

iHIGH ADDR OF ROOT SEGMENT + 2 <NXT AVAIL) 
; HIGH ADDRESS OF /O OVERLAYS +2 <NXT AVAIL) 



*** Assembler statistics 
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Work file reads: 
Work file writes: 
Size of work file: 
Size of core pool: 
Operating system: 



u 



10442 Words 

18176 Words 

RT-11 



41 
71 



Pages ) 
Pages ) 



Elapsed time: 00:00:07.25 

, LP: OHANDL=DK: OHANDL/C/N: SYM 
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Cross reference table CCREF V05. 05) 



*0DF1 

*0DF2 

*0VDF1 

*0VDF2 

*OVRH 

*OVTAB 

... VI 



. . . V27 
. . . V28 
. . . V5 
. . . V6 

. OHAND 
0*D0NE 
OSREAD 



4-42 

4-44 

4-48 

4-49 

4-12# 

3-17# 

3-2# 

1-2 

1-2 

l-2# 

1-2 

4 *-l 
*— «t 

l-2# 

1-2 

l-2# 

1~2# 

4-31# 

4-30# 



4-4S# 
4-49# 



4-19 

4-30 

1-2 

1-2 

l-2# 

1-2 



1-2 
l-2# 



4-30 
1-2 

1-2 



1-2 
1-2 



1-2 
1-2 



1-2 
1-2 



1-2 



1-2 
l-2# 



1-2 
l-2# 



1-2 
l-2# 



1-2 
l-2# 



1-2 
l-2# 



1-2 
1~2# 



1-i 



1-2 



l-2# 



l-2# 



l-2# 



l-2# 
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Cross reference table (CREF V05. 05) 



. . CriO 


3-2# 


. . CM1 


3-2# 


. . CM2 


3-2# 


. . CM3 


3-2# 


. . CM4 


3-2# 


. . CMS 


3~2# 


. . CM6 


3-2# 


. . CM7 


3-2# 


. VI. . 


3-l# 


AUDIT 


l-2# 


MODUL 


1-1# 


NLCSI 


i-2# 


READW 


3-l# 


RMODU 


l-2# 



-30 



4-30 



4-30 



4-30 

4-30 
3-2 

1-2 

4-30 
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